Inside Macintosh: QuickDraw GX Printing /

Chapter 3 - Page Formatting and Dialog Box Customization / Page Formatting and Dialog Box Customization Reference

Application-Defined Functions

Looping Through Format Objects

When you want to make changes to each format object associated with a document, you can use the GXForEachJobFormatDo function to access format objects. In this function you must provide a pointer to a format function.

To access each format object associated with a printable document, provide a pointer to a format function in the GXForEachJobFormatDo function that takes two parameters: the format object associated with a particular job object, and a pointer to a reference constant in which you specify unique format object references. For example, this is how you should declare the function if you were to name it MyFormatFunction:

gxLoopStatus MyFormatFunction (gxFormat aFormat, void *refCon);

aFormat

The current format. This is provided by QuickDraw GX when the function is called.

refCon

A pointer to a reference constant for each format object.

function result

A Boolean value to indicate whether looping should stop.

DESCRIPTION

When you use the GXForEachJobFormatDo function, QuickDraw GX calls your format function multiple times as it retrieves each format object referenced by a job object.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help